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Introduction 



Overview 



Letterman is a word guessing game similar to hangman— except no one is hanged. 
Instead, Letterman uses lively animation, colorful graphics, and sound effects to 
provide an exciting learning experience. The program contains more than 400 words 
in three difficulty levels. Either the computer can select a secret word from this list or a 
friend can type in a word for you to guess. You have six turns in which to guess the 
word, one letter at a time. You guess by typing a letter on your computer keyboard and 
watching the results. 

Owing to different computer memory requirements, the cassette and diskette versions 
differ slightly. Both work as described above. However, the diskette version offers 
some added features. You can request hints if you get stuck. You can choose to play 
under a time limitation for making each guess. And, the program can keep track of as 
many as nine players' turns and scores. 

When you're familiar with the 400 words in the program's list, you can continue to 
enjoy Letterman by adding to (if your system has 24K of RAM for the cassette version 
or 32K of RAM for the diskette version) or revising the list, following the instructions in 
this manual. 



ATARI BASIC Language Cartridge 

• Cassette version 

16K RAM 

ATARI 410 Program Recorder 

• Diskette version 

32K RAM 

ATARI 810 Disk Drive 



Users wishing to contact the authors about Letterman may write to them at: 



Required accessories 



Contacting the authors 



Ray Lyons 

344 Reinhard Avenue 
Columbus, Ohio 43206 



Ed Stewart 
11025 Sagebrush 
Uniontown, Ohio 44685 



or call them at: 



614/443-2259 



216/866-6006 
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Getting started 



Loadins Letterman into computer memory 

1. Insert the ATARI BASIC Language Cartridge in the cartrrdge slot of your 

computer. 

2. If you have the cassette version of Letterman: 

a. Connect your program recorder to the computer and to a wall outlet. 

b. Turn on your computer and your TV set. 

c. Slide the Letterman cassette into the program recorder's cassette holder and 
press REWIND on the recorder until the tape rewinds completely. Then press 
PLAY. 

d. Type CLOAD on your computer and then press the RETURN key two times. 
The tape will load into computer memory. 

e. After the tape finishes loading, the word READY will display on your TV 
screen. Type RUN and pressi the RETURN key. The programt's first display 
screen will appear on your TV screen. 

// you have the diskette version of Letterman: 

a. Turn on your disk drive. 

b. When the BUSY light goes out, open the disk drive door and insert the 
Lefferman diskette with the label in the lower right-hand corner nearest to 
you. Close the door. 

c. Turn on your computer and TV set. 

d. When the READY prompt displays on your TV screen, type RUN "D; 
LTTRMAN" and press the RETURN key. The program will load into 
computer memory and start. 

The first display screen 

After a few seconds, Letterman welcomes you with a special musical greeting and title 
display. Then you select your game optjon(s) — word difUculty level (and for the 
diskette verstor*, whether to have hints, the number of players* and whether to have a 
time limitation). 
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Word difficulty level 



The WORD LEVEL choices appear immediately after the introduction. It looks 
roughly like this: 

SELECT WORD LEVEL 
EASY 
SO-SO 

GOOD LUCK 
THEN PRESS START 

The orange word (or the lighter shade, if your TV screen is black and white) indicates 
your currently selected option. Press the SELECT key to change the level u ntil the one 
you want displays in orange; then press START to go on to the next option. 



Diskette version - HINTS, NUMBER OF PLWERS, and 
TIME LIMIT options 

The diskette version of Letterman next asks you to indicate whether you want to play 
with hints. Press the SELECT key to choose your option (HINTS or NO HINTS), and 
then press START to continue. 

Next, the program asks you to enter the number of players. Your choices are "1 
PLAYER" and "2 OR MORE PLAYERS". Press the SELECT key to choose your option 
and then press the START key to continue. ^ 

A third option in the diskette version asks you to indicate whether you want a time limit 
per guess. Using a time limit can help make a game more fair. Your choices are TIME 
LIMIT and NO TIME LIMIT. Press the SELECT key to choose your option and then 
press the START key to continue. 

If you chose 2 OR MORE PLAYERS for the SELECT PLAYERS option, the program 
will now ask you to enter the number of players. Enter a number between 2 and 9 
(pressing the RETURN key isn't necessary). 

If you chose a TIME LIMIT, the program will next ask you to enter how many seconds 
you want the limit to be. Enter your number and press the RETURN key to go on to the 
final option. 

Selecting the secret word 

[Note for diskette version. If you choose the 2 OR MORE PLAYERS option, you'll hear 
a tone and the number of the player flashes on the lower left of your TV screen.] 

Letterman next asks you to select a secret word. The message is "ENTER A SECRET 
WORD.. .OR SELECT A WORD". You have two choices. You may either enter the 
secret word yourself (or have another player do so for you to guess), or you may have 
Letterman pick a word for you to guess. 
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Entering the secret word yourself. You may type a word on your keyboard. When you 
enter your secret word, it won't display on the TV screen. Instead, blue dashes (or dark 
shading^or black and white TV sereens) display, one dash for each tetter you type. 
Your word can be as long as 15 letters. Don't use numt^rs, punctuation, CTRL 
characters, or other keys. A buzzer sounds if you press any key other than a letter. 

You can erase a letter by backspacing with the DELETE/BACK S key. When youVe 

entered the word correctly, press the START key to begin playing. {Note. You can 
change your mind and have Lefierma/i select your secret word instead by pressing the 
SELECT key ata4^y4imeb0forafN'esslng the START^ey.^ will then Ignore 

anyttitng you've typed in and picka word for you.) 

Letttngihe computer select the secret word. To teliLetterman to pick a secret word for 
you, pressthe SELECT key. LeffermaiT will selecta word randomly from the difficulty 

level you chose earlier. Orange (or light shading for black and white TV screens) 
representing the number of letters in the secret word display on the screen. (Note. 
Onoe you tell Xenerman to select a word for you, can't charge your mind and 
enter yoiir own.) 

Letterman won't repeat words during a game sessioru However, b^ may do so if you 
rerun the progratn. 



Playins Letterman 



Guessing the secret word 

Once you've picked your options, the alphabet displays at the top of your TV screen. 
For the cassette version and for the 1 PLAYER option in the diskette version, a "W" (for 
"wins") and "L" (for "losses") display to the right of the alphabet for scoring. For the 2 
OR MORE PLAYERS in the diskette version, the "W"/"L" information displays briefly 
at the bottom right of the screen following each player's turn. 

It's now your turn to guess a letter. Type in any letter (letters only). If your letter is part 
of the secret word, the letter replaces the dash (es) correspondi ng to where it belongs 
in the word (it can replace one or more dashes), and it also disappears from the 
alphabet display. Letterman does a little "dance for joy", since your correct guess has 
kept the arrow from coming closer to his juicy apple! However, if you guess 
incorrectly, the arrow swishes towards the apple on Letterman's head and the letter 
you chose disappears from the alphabet display. 

You may make six (6) incorrect guesses before Letterman ends your turn and displays 
the secret word. 

Hints in diskette version 

If you selected to use HINTS, why not try one when you get stuck? Type in a question 

mark by pressing the SHIFT and ? keys and then watch the screen. Letterman chooses 
the hints and may give you the same hint twice (too bad . . . ). Here are the kinds of hints 
you can expect: 

FIRST LETTER = (first letter of secret word) 
LAST LETTER = (last letter of secret word) 

# VOWELS = (total A.E,I,0,U, and Vs in the word) 

# HARD ONES = (total J, Q, V, X, and Z's in the word) 
You're allowed only two hints per turn. 

Time limit for diskette version 

If you're playing with a time limit, Letterman automatically starts keeping time from the 
moment the alphabet displays on your screen until you type in your first guess, and it 
times all other guesses. 
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Letterman notifies you when you have 30 seconds left to type in your guess. A tone 
sounds and a countdown displays on the screen. If you chose a time limit less than 

30 seconds, the countdown displays as soon as a turn begins. If you chose a time limit 
more than 30 seconds, Letterman keeps time quietly until it reaches the 30-secQnd 
mark. 

If you don't enter your guess before the count reaches zero, you lose that guess. A 
buzzer sounds and the arrow swishes toward the appiel Letterman then resets the 
timer for your next gu^s and again warn^^ left for 

guessing. 

You can play Letterman as long as you \ '\ke. To change game options during the gam^e, 
see the section below. 



Giving up 

If you don't want to continue guessing during, a turn, you may end your turn by 
pressing the CTRL and Q keys, for "quit". Lert©rm^if?#^ displays tt^secret word and 

adds 1 to your "loss" score. However, Letterman's apple escapes the arrowl 

Changing options during a gcime 

You may change any options after finishing a turn, when the "ENTER A SECRET 
WORD ... OR SELEeTA WORD^messagedisp^ays. Pressthe OPTION key icistead of 
the SELECT or START keys to tell Letterman to return to the options. To change one 
option, you must go through all the options for the cassette or diskette version. 
Letterman resets all scores to zero when you change options. 

Scoring 

When you guess a word, Letterman xioes a colorful dance, among other surprises. 

When you miss a word, Letterman becomes gloomy and flees from the poor squished 
apple. 

Each word you guess earns you one point in your WIN column. Each word you fail to 
guess results in one point in your LOSS column. Your score displays immediately in 
the cassette >^rsion and in the 1 PLAYER option of the diskette version. It displays 
after each turn for the 2 OR MORE PLAYER option of the diskette ve^^ 

Restarting or replaying Letterman 

You can interrupt Letterman at any time and start over by pressing the SYSTEM 
RESET key. When the READY prompt displays, type RUN and press the RETURN key. 

If you accidentally stop Letterman by pressing the BREAK key, flashing vertical strips 
will appear on your screen. Use the SYSTEM RESET key, RUN comrnand, and 
RETURN key, as described above, to sta^^^ 
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Problems 



You may encounter one problem with Letterman. If you accidentally press the ATARI 
Inverse key or the CAPS/LOWR key in response to the message ENTER A SECRET 
WORD ... OR SELECT A WORD, the words "ENTER" and "OR" will stop flashing 
because the computer senses a key has been pressed, but it has a bit of trouble with 
these two keys. It's expecting you to press a letter key. 

If you meant to type in your own secret word, go ahead and type it in and then press 
the START key. If you wanted Letterman to select the word, type in any letter and then 
press the SELECT key. 

You needn't worry if you press either of these two keys during game play. The 
program will continue to run normally. 
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Advanced technical information 




ing or adding words to Letterman 

You can change the worclUsts contained in the l^t^mmi p^ 

//77porfanf. Don't change your original version of Lefterma/?, Mak^^ 
on a copy of thaprogmm, " 

fn the subroutine beginning at line 4000, the word list for any given difficulty level is 
assigned to the string "W$" (see Nnes 4000-4299). Difficulty levels are divided as 
follows: ■. 

Table 1 Word List Sections of Progrann 

Difficulty Line nos. # Words # Words 

level in section in section 

' _____ (cassette) (diskette) 

EASY 4000-4O99 123 126 

SO^SO 41004^199 126 138 

GOOD LUCK 4200-4299 1^ 148 



Chansing the word Ust 



1. To change words, LIST the program on your TV screen (e.g., use the command 
LIST 4000,4099 to list the line numbers for. the EASY These \itm will 
have the folJpvwi^ form: . : 

Une no. W$(Z,ZH- WL)="words . . . " 

2. Type your new words right over the words appearing between the quotation 
marks. Leai^e at least one space between each word you type. Be careful not to 
go past the final quotation mark, unless room remains on that logiMl line^to 
extend the string. Remember to usethe final quo^tfon nruirk. Alsoj teave at least 
Of?espace before the quotation mark ending each logical line. 

3. Then use the SAVE cornmand to stor^lhis fo^dified 

to the ATARI BASIC Reference Marfmf^ more information about saving a 
program) . If you change the total number of words in any of the three levels, you 
must also change the value of the variaWe WCNT, as desGrib^^ in the next 
section. 
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Adding to the word list 

To add words to Letterman, you must have at least 24K of RAM for the cassette version 
or 32K of RAM for the diskette version. The maximum number of words this program 
supports for each difficulty level is 255. The program won't work correctly if you 
extend this limit. 

Note. If you add words to a copy of this program and save such a revision, the cassette 

version won't load in 16K of RAM. 

1. You add more words to the program by adding lines. For any difficulty level, 
choose new line numbers for your lines that are within the ranges appearing in 
Table 1 above. For example, to add new words to the EASY level, choose line 
numbers between 4026 (the first available line number within this range) and 
4098 (the last available line number within this range). 

Use this form to enter your new lines: 

new line no. W$(Z,Z+WL)="enter new words here" 

You may enter up to one logical line's worth of words within the quotation marks. 
Leave at least one space between each word you type within the quotation marks 

and leave one space before the final quotation mark in each new logical line. 

2. The program can accommodate up to 255 words in each difficulty level. The 
number of words in a section (see Table 1) is stored in the variable WCNT. You'll 
need to update this value by LISTing to the screen the last line of the word level 
section to which you're adding. This line will be 4099 for EASY. 4199 for SO-SO, 
and 4299 for GOOD LUCK. It will have this format (where "X" is the appropriate 
hundreds digit): 

4X99 WCNT=(no. of words in section):RETURN 

Change the number to the right of the equal sign to reflect the total number of 

words now in that section. For example, if WCNT=138 before you added twenty 
words, change the value of WCNT to 158. 

3. SAVE this expanded version on a different cassette tape or under a different 

diskette file name. Refer to the ATARI BASIC Reference Manual for more 
information about saving programs. 



Advanced technical information 9 



Machine languase subroutine to select the secret word 

Owing to the great length of the string variable W$, including a machine language 
subroutine to search this string was necessary. (BASIC took too long.) This routine is 
included here because it's general enough to be usefuf for other purposes. The routine 
chooses the Nth word from a string and returns its relative byte offset within that 
string. The calling sequence is: 

OFFSET=USRt 1536ADR( W$),N) 

where N is the word numijer to select refative to one, and OFFSET is set to equal the 

displacement within W$ of the Nth word. OFFSET is relative to zero. To save space, 
this routine is contained in Letterman in character form in line 9120. ATASCII codes of 
these charactersare POKEd into locations t536-1602 (decimal). The prograiT^itsting 
appears on the following page. 
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Machine Language Listing 



P\ ATT A 


A P\P\D 

AUUn 


1 A DCI 

LAt5tL 


UK UUUt 


UrtnAiViU 


UvJMMtN 1 o 


104 


600 




PLA 




PULL OFFPARM COUNT 


104 


601 




PLA 




PULL 


133,204 


602 




STA 


$204 


OFF 


104 


604 




PLA 




STRING ADDR 


133,203 


605 




STA 


$203 


AND SAVE IT 


104 


607 




PLA 




HI-BYTE OF "n" IS ZERO 


133,212 


608 




STA 


$212 


CLEAR RESULT 


133,213 


60A 




STA 


$213 


AREA 


168 


60C 




TAY 




AND INDEX 


104 


60D 




PLA 




GET WORD COUNT 


133,205 


60E 




STA 


$205 


AND SAVE IT 


234 


610 




NOP 




RESERVE FOR BUGS 


177,203 


611 


SCAN1 


LDA 


$203, Y 


GET STRING VALUE 


201 ,32 


613 




CMP 


If n 


Q. IS IT BLANK 


208,16 


615 




8NE 


SCAN2 


A. YES, DO WORD COUNT 


230,212 


617 


SCANIA 


INC 


$212 


+1 TO STRING LENGTH 


208,2 


619 




BNE 


B1 


NO OVERFLOW 


230,213 


61 B 




INC 


$213 


+1 TO HI-ORDER BYTE 


200 


61 D 


81 


INY 




+1 TO INDEX 


208,2 


61 E 




BNE 


82 


NO OVERFLOW 


230,204 


620 




INC 


$204 


+1 TO ADDR HI-ORDER BYTE 


76,17,6 


622 


82 


JMP 


SCAN1 


CONTINUE SCAN 


234 


625 




NOP 




RESERVE FOR BUGS 


234 


626 




NOP 




RESERVE FOR BUGS 


198,205 


627 


SCAN2 


DEC 


$205 


REDUCE WORD COUNT 


208,1 


629 




8NE 


83 


MORE WORK TO DO 


96 


62B 




RTS 




RETURN IF NO MORE WORDS 


230,212 


62C 


83 


INC 


$212 


+1 TO STRING LENGTH 


208,2 


62E 




8NE 


84 


NO OVERFLOW 


230,213 


630 




INC 


$213 


+1 TO HI-ORDER BYTE 


200 


632 


84 


INY 




+1 TO INDEX 


208,2 


633 




BNE 


85 


NO OVERFLOW 


230,204 


635 




INC 


$204 


+1 TO ADDR HI-ORDER BYTE 


177,203 


637 


85 


LDA 


$203,Y 


GET STRING BYTE 


201 ,32 


639 




CMP 


It n 


Q. IS IT BLANK 


208,3 


638 




BNE 


86 


A. NO GO SCAN FOR A BLANK 


76,17,6 


63D 




JMP 


SCANIA 


GO BACK TO BLANKS SCAN 


76,44,6 


640 


86 


JMP 


83 


CONTINUE NON-BLANKS SCAN 



Advanced technical information 11 



ATARI* 
JPROGRAM 
EXCHANGE 

P.O. Box 3705 

Santa Clara, CA 96055 



Review Form 




We're interested in your experiences with APX programs 
and documentation, both favorable and unfavorable. 
Many of our authors are eager to improve their programs 
if they know what you want. And, of course, we want to 
know about any bugs that slipped by us, so that the 
author can fix them. We also want to know whether our 

1. Name and APX number of program. 



instructions are meeting your needs. You are our best 
source for suggesting improvements! Please help us by 
taking a moment to fill in this review sheet. Fold the sheet 
in thirds and seal it so that the address on the bottom of 
the back becomes the envelope front. Thank you for 
helping us! 



2. If you have problems using the program, please describe them here. 



3. What do you especially like about this program? 



4. What do you think the program's weaknesses are? 



5. How can the catalog description be more accurate or comprehensive? 



6. Onascaleof 1 to 10, 1 being "poor" and 10 being "excellent", please rate the following aspects of this program: 
___ Easy to use 

____ User-oriented (e.g., menus, prompts, clear language) 

Enjoyable 

Self-Instructive 

Useful (non-game programs) 

Imaginative graphics and sound 



7. Describe any technical errars you found in the user instructions (please give page numbers)^ 




8. What did you especially like about the yser instructi(;>n$? 



9. What revisions or additions would improve these instructiorts? 



10. On a scale of 1 to 10, 1 representing "poor" and 10 representing "excellent", how would you rate the user 
instructions and why? 




11. Other comments about the program or user instructions: 



From 



STAMP 



ATARI Program Exchange 

P.O. Box 3705 

Santa Clara, CA 95055 



• 



[seal here] 



LETTERMAN 

by Ed Stewart and Ray Lyons 

Recommended for ages 8 and up/ Written in BASIC 

• Colorful animation and lively sjQunds 

• Friendly theme ^ 

• Nearly 400 words with three selectable difficulty levels— or add 
your own words 

Has it ever bothered you that a game as fun as hangman has a 
violent underlying premise? Well, here's a variation on the tradi- 
tional paper and pencil, word-guessing gamethat replaces a dismal 
outcome with lively animation, colorful graphics, and amusing 
sound effects. The only object in danger is the apple on Letterman's 
head! You have six turns in which to guess the secret word, one letter 
atatime. Eitherthe program or another playercan choose the word. 
Letterman contains nearly 400 words within three selectable 
difficulty levels. And when you've exhausted this list you can 
continue to enjoy Letterman because the user manual contains 
easy-to-follow instructions for adding to (if your system has more 
than 16K of RAM) or revising Letterman's list of words. 

Owing to different computer memory requirements, the cassette 
and the diskette versions differ slightly. Both versions work as 
described above. However, the diskette version offers some added 
features. You can request hints if you get stuck. You can also choose 
to play under a time limitation for making each guess. And the 
program can keep track of as many as nine players' turns and 
scores. 

The authors invite comments by mail and telephone. 



RAY LYONS and ED STEWART 





About the authors 



Photos by Lynn Shaulis 



Ray Lyons and Ed Stewart have been friends for twenty years, since 
they were Boy Scouts together. They both acquired their ATARI 
Home Computers two years ago. During one get-together of their 
families, they played Atari's Hangman. They decided to try their own 
version, and during an all-night programming session, they created 
Letterman. Instead of adding another limb to a hanging person, Ray 
and Ed's version shoots an arrow at an apple perched on top of 
Letterman's head. Ed, a systems programmer for a large tire 
manufacturer in Akron, Ohio, has written articles about ATARI 
Computers for computer magazines. Ray works as a writer for a 
large computer library center in Columbus, Ohio. 



ATARI® 

PROGRAM 

EXCHANGE 




REVIEW COMMENTS 

The graphics features and lively, friendly approach used in every 
aspect of Letterman make this program especially appealing. 

The user manual is very good. 



Cassette: version 1 Diskette: version 1 

Edition B 



P.O. Box 3705 



Limited Warranty on Media and Hardware Accessories. Atari, Inc ( Atari ) 
warrants to the original consumer purchaser that the media on which APX 
Computer Programs are recorded and any hardware accessories sold by APX 
shall be free from defects in material or workmanship for a period of thirty (30) 
days from thedateof purchase. If you discover such a defect within the30-day 
period, call APX for a return authorization number, and then return the product 
to APX along with proof of purchase date. We will repair or replace the product 
at our option. If you ship an APX product for in-warranty service, we suggest 
you package it securely with the problem indicated in writing and insure it for 
value, as Atari assumes no liability for loss or damage incurred during 
shipment. 

This warranty shall not apply if the APX product has been damaged by 
accident, unreasonable use, use with any non-ATARI products, unauthorized 
service, or by other causes unrelated to defective materials or workmanship. 

Any applicable implied warranties, including warranties of merchantability 
and fitness for a particular purpose, are also limited to thirty (30) days from the 
date of purchase. Consequential or incidental damages resulting from a 
breach of any applicable express or implied warranties are hereby excluded. 

The provisions of the foregoing warranty are valid in the U S. only. This 
warranty gives you specific legal rights and you may also have other rights 
which vary from state to state. Some states do not allow limitations on how long 
an implied warranty lasts, and/or do not allow the exclusion of incidental or 
consequential damages, so the above limitations and exclusions may not apply 
to you. 

Disclaimer of Warranty on APX Computer Programs. Most APX Computer 
Programs have been written by people not employed by Atari. The programs 
we select for APX offer something of value that we want to make available to 
ATARI Home Computer owners. In ordertoeconomically offerthese programs 
to the widest number of people, APX Computer Programs are not rigorously 
tested by Atari and are sold on an "as is" basis without warranty of any kind. 
Any statements concerning the capabilities or utility of APX Computer 
Programs are not to be construed as express or implied warranties. 

Atari shall have no liability or responsibility to the original consumer pur- 
chaser or any other person or entity with respect to any claim, loss, liability, or 
damage caused or alleged to be caused directly or indirectly by APX Computer 
Programs. This disclaimer includes, but is not limited to, any interruption of 
services, loss of business or anticipatory profits, and/or incidental or conse- 
quential damages resulting from the purchase, use, or operation of APX 
Computer Programs. 

Some states do not allow the limitation or exclusion of implied warranties or 
of incidental or consequential damages, so the above limitations or exclusions 
concerning APX Computer Programs may not apply to you. 



For the complete list of current 
APX programs, ask your ATARI retailer 
for the APX Product Catalog 



